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Preface 


The SharedPrint/UX User and Administrator’s Guide for HP-UX 10.0 
describes procedures for configuring, troubleshooting, using, and extending 
SharedPrint/UX. SharedPrint/UX is client-server software that includes a 
graphical user interface for printing. 

The manual also introduces the SharedPrint/UX Manager, which helps 
administrators manage SharedPrint/UX print requests and other print requests 
in a networked environment. 

This manual is organized as follows: 


Chapter 1 

Introducing SharedPrint/UX 

Chapter 2 

Setting Up SharedPrint/UX 

Chapter 3 

Using SharedPrint/UX 

Chapter 4 

Understanding the SharedPrint/UX 
Architecture 

Chapter 5 

Using SharedPrint/UX Filters 

Chapter 6 

Extending SharedPrint/UX 

Chapter 7 

Troubleshooting SharedPrint/UX 

Appendix A 

SharedPrint/UX Printing Options 

Appendix B 

CGM Support 

Appendix C 

Meeting NCS of DCE Requirements 



Problems, Questions, and Suggestions 

If you have any questions or problems with our hardware, software, or 
documentation, please contact either your HP Response Center or your local 
HP representative. 
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Introducing SharedPrint/UX 


SharedPrint/UX enhances the basic capabilities of the Ip spooling system, 
using a client-server implementation. SharedPrint/UX is included as part of 
HP-UX 10.0 on all HP 9000 Series 700 and 800 systems as SharedPrint/UX 
version 1.5. 

SharedPrint/UX includes two graphical user interfaces: 

■ The SharedPrint/UX printing interface, which lets you print many types 
of hies by dropping hie icons on the HP VUE Printer control or Printers 
subpanel 

■ The SharedPrint/UX Manager, which lets you check the status of printers 
and print requests and administer SharedPrint/UX printers 


SharedPrint/UX Features 

SharedPrint/UX provides these features: 

■ Graphical User Interfaces that you use to make print requests, set options, 
check the queue status, and set defaults for future print requests 

■ Integration of the System Administration Manager (SAM) for printer setup 
and conhguration. 

■ Drag and drop printing in the HP VUE Eile Manager, so you can select a hie 
and drop it on the printer icon 

■ Support of a wide array of HP hardcopy devices such as laser printers, color 
ink-jet printers, and large format plotters for certain types of hies 

■ Adherence to industry standard hie formats such as PCL, CGM, X-windows 
bitmaps, and TIEE 
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SharedPrint/UX From the ip Command 

You can also use SharedPrint/UX with the Ip command; you can use any of 
the options found in SharedPrint/UX Graphical User Interface. See Appendix 
A for a list of option names. 


Printers Needed for Specific Files 

Figure 1-1 provides a overview of what types of hies you can print using 
SharedPrint/UX. The following hies require specihc printers: 

■ PostScript and Encapsulated PostScript hies require a PostScript printer. 

■ CGM hies require an HP-GL/2 printer. 

■ Bitmap and Pixmap hies require a PCL or PostScript printer. 

If you are printing PCL3 or higher hies on a PCLl or PCL2 printer, 
SharedPrint/UX automatically converts the hie to print correctly. Chapter 5 
describes how SharedPrint/UX converts hies to different printer formats. 

For more detail on what hies you can print, see the section “Types of Files 
Supported,” which follows. 
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Figure 1-1. SharedPrint/UX Access to Files, Printers, and Plotters 
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Types of Files Supported 

SharedPrint/UX can print the types of files listed in Table 1-1. 


Note For details about some printers requirements, see the preceding 

section, “Printers Needed for Specihc Files.” 


Table 1-1. Files Supported by SharedPrint/UX 


File Type 

File Contents 

Version Snpported 

TIFF 

PG, scanned, and FAX images 

5.0 (6.0 for TIFF JPEG) 

JFIF 

JPEG-compressed images 

8-R8 

GIF 

XV and xgif images 

87a and 89a 

XWD 

Pixmap images from xwd (Z format) 

Xll^ 

XBM 

Bitonal X bitmap images 

Xll 

XPM 

Golor X pixmap images 

3.0 

BMF 

Starbase pixmap images (Z format) 

ll 

HP-GL/2 

Vector Gommands 

1 

PCI 

HP Page Description Language 

1 through 5 

Postscript 

Adobe Page Description Language 

(not applicable) 

EPS 

Encapsulated PostScript Object 

3.0 

CGM 

Gomputer Graphics Metafile 

(not applicable) 

Text 

8-bit text 

(not applicable) 

IMG 

PG bitmap image 

3.0 

PGX 

PG bitmap image 

3.0 

BMP 

GEM PG images 

(not applicable) 


1 The Z format, noted for BMP and XWD files, refers to a pixel-oriented bitmap format. 
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Printing TIFF Files 

SharedPrint/UX can print any type of TIFF image file that the HP-UX Image 
Library can read. The following TIFF hies can be printed: 

■ Bitonal (1-bit) 

■ Grayscale (4 and 8-bit) 

■ Palette (4 and 8-bit color) 

■ RGB (12 and 24-bit color) 

■ YCbCr (24-bit color) 

The TIFF images you can print can be in uncompressed format or in any of 
the following compressed formats: 

■ JPEG (Grayscale, RGB, and YCbCr images) 

■ LZW (Bitonal, Grayscale, RGB, and YCbCr images) 

■ CCITT Group 3 and 4, TIFF-compatible Group 3 (Bitonal images) 

■ Packbits (Grayscale, RGB, Bitonal images) 


Introducing SharedPrint/UX 1-5 



Printers and Plotters Supported 

SharedPrint/UX supports the following printers and plotters. To add support 
for additional printers, see Chapter 6, Extending SharedPrint/UX. 

■ HP LaserJet II 

■ HP LaserJet HD 

■ HP LaserJet IIP 

■ HP LaserJet III 

■ HP LaserJet HID 

■ HP LaserJet HIP 

■ HP LaserJet IllSi 

■ HP LaserJet 4 

■ HP LaserJet 4L 

■ HP LaserJet 4M 

■ HP LaserJet 4ML 

■ HP LaserJet 4MP 

■ HP LaserJet 4P 

■ HP LaserJet 4Si 

■ HP LaserJet 4Si MX 

■ HP PaintJet 

■ HP PaintJet XL 

■ HP PaintJet XL300 

■ HP DesignJet 

■ HP DesignJet 200 

■ HP DesignJet 650C 

■ HP DeskJet 

■ HP DeskJet 500 

■ HP DeskJet 500C 

■ HP DeskJet 520 

■ HP DeskJet 550C 

■ HP DeskJet 560C 

■ HP DeskJet 1200C 

■ Most 300 dpi monochrome Postscript ® printers (including HP LaserJet 
with Postscript ® cartridge) 

■ HP Model 250/255 monochrome electrostatic plotters 

■ HP Model 355 color electrostatic plotter 

■ HP DraftMaster MX/RX/SX plotter (HP-GL/2 and CGM only) 

■ Tektronix 4693DX and Tektronix Phaser I 
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Basic Architecture of SharedPrint/UX 

SharedPrint/UX uses a client/server implementation. The SharedPrint/UX 
client contains the user interface, while the SharedPrint/UX server contains 
the software that processes print requests. The server software invokes the 
necessary conversion and formatting hlters, and controls the use of printer 
capabilities, such as duplex printing and tray selection. 

Figure 1-2 illustrates the client/server architecture of SharedPrint/UX. For 
more detail, see Chapter 4, Understanding the SharedPrint/UX Architectnre. 



Figure 1-2. SharedPrint/UX Client Server Architecture 
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Setting Up SharedPrint/UX 


You can use this chapter for three tasks: 

■ To conhgure local printers to support SharedPrint/UX 

■ To add remote printers that were conhgured for SharedPrint/UX 

■ To enable printing via SharedPrint/UX on a user’s system 


Configuring Local Printers for SharedPrint/UX 

Check the printer you need is listed under “Supported printers and plotters” in 
Chapter 1. Then, choose a procedure that applies: 

■ Printer Attached to SharedPrint/UX Server 

■ Printer Controlled by JetDirect Network Software 

■ Printer Attached to an X Station 

Note If you are using a localized version of SharedPrint/UX, one 

additional step exists. When you use sam to add or remove 
printers, hrst set your locale to C. In an hpterm window, type: 

export LANG=C 


On Series 800 Systems 

An X display is required for the setup_pr script referenced in this chapter. If 
the system you are using has no X display, replace the setup_pr step with the 
section “Alternative to setup_pr” later in this chapter. 
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Printer Attached to SharedPrint/UX Server 

1. Become root on the SharedPrint/UX server. 

2. Use sam as follows: 

a. Use the Printer/Plotter Manager to list printers on your system. 

b. If the list includes the printer you planned to add for SharedPrint/UX, 
use the sam action for removing it. (By completing subsequent steps, you 
add it back for use by both SharedPrint/UX and Ip.) 

c. Use the procedure for adding a local printer, hlling in these helds as 
follows: 

Printer Name - assign a name to the printer. 

Printer Model/Interface - click this button to select a printer model 
number that sam lists as a SharedPrint model. 

■ Select PS if the printer only accepts PostScript input 

■ Select a different SharedPrint model if the printer handles multiple 
types of hies. 

d. Exit sam. 

3. Execute the following script, responding to prompts that guide you through 
the set up: 

/opt/sharedprint/lbin/setup_pr.sh 

Eor a parallel printer, no input is required; choose Quit instead of OK to 
dismiss the dialog. 

The setup_pr.sh script is required as a check that NCS or HP DCE/9000 
is set up on the network. If setup_pr issues a message that neither is set 
up, see Appendix C, “Meeting NCS or DCE Requirements.” 

4. If this is a parallel printer, add the following line to the /etc/inittab hie: 

Ip: 2: once:/usr/bin/slp -r /dev/ device-filename 2>/dev/null 

Eor device-filename, supply the appropriate hie name. 

5. If the printer will be used for color graphics, see “Modifying Color Printers” 
later in this chapter. 

6. Conhgure other printers (if needed) using a procedure in this chapter. 

7. When all printers are conhgured, see “Enabling SharedPrint/UX on a 
System” at the end of this chapter. 
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Printer Controlled by JetDirect Network Software 

1. Become root on the SharedPrint/UX server. 

2. If you have not installed the JetDirect Network software (separately 
purchased TCP/IP software) on the SharedPrint/UX server, use the 
documentation that comes with the TCP/IP Ethernet Network Peripheral 
Interface to install this TCP/IP software. 

3. Use the JetDirect jetadmin command as follows: 

■ Conhgure the boot server for this printer. 

■ Add this printer to the spooler. 

■ Change the model script for this printer to: sharedprint 

4. Execute the following script, responding to the prompts that guide you 
through the set up: 

/opt/sharedprint/lbin/setup_pr.sh 

When prompted for a model number, use these guidelines: 

■ Select PostScript-Only if the printer only accepts PostScript input. 

■ Select a different model if the printer handles multiple types of hies. 

If you receive a message that NCS or DCE is not set up, see Appendix C, 
“Meeting NCS or DCE Requirements.” 

5. If the printer will be used for color graphics, see “Modifying Color Printers,” 
later in this chapter. 

6. Conhgure other printers (if needed) using a procedure in this chapter. 

7. When all printers are conhgured, see “Enabling SharedPrint/UX on a 
System,” at the end of this chapter. 

Printer attached to an X Station 

1. Attach the printer to the serial or parallel port of an HP 700/RX, HP 
ENVIZEX Station, or ENTRIA X Station. 

2. If the printer is connected to the parallel port, skip to step 3. If the printer 
is connected to serial port, perform these steps: 
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a. Hold the F12 key on the X station keyboard until the setup window 
appears. 

b. Choose the Terminal button. 

c. Set the Serial Port parameters to match your printer. 

d. Choose OK to close the setup window. 

e. Continue with step 3. 

3. Become root on the system that is the X server for the X Station. 

4. If this is a parallel printer, add the following line to the /etc/inittab hie: 

Ip: 2: once:/usr/bin/slp -r /dev/ device-filename 2>/dev/null 
For device-filename, supply the appropriate hie name. 

5. If the X station is not an HP 700/RX, skip to the next step. 

For an HP 700/RX, make sure that the HP 700/RX software is at least 

Release B.04.01. 

6. Run xtadm and respond to the prompts as follows: 

a. From the main menu, choose Printers, plotters. 

b. From the next menu, choose Add a printer or plotter. 

c. Respond to all prompts, entering sharedprint at this prompt: 

Enter printer type or to see choices. 

If you enter * to see choices, sharedprint appears with an 0 symbol; 
however, you omit this symbol. 

7. Exit xtadm by choosing p, then x. 

8. Execute the following script, responding to the prompts that guide you 
through the set up: 

/opt/sharedprint/lbin/setup_pr.sh 

When prompted for a model number, use these guidelines: 

■ Select PostScript-Only if the printer only accepts PostScript input. 

■ Select a different model if the printer handles multiple types of hies. 

If you receive a message that NCS or DCF is not set up, you need to set up 
either NCS or HP DCE/9000 on your network. See Appendix C, “Meeting 
NCS or DCF Requirements.” 
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9. If the printer will be used for color graphics, see “Modifying Color 
Printers,” later in this chapter. 

10. Conhgure other printers (if needed) using a procedure in this chapter. 

11. When all printers are conhgured, see “Enabling SharedPrint/UX on a 
System” at the end of this chapter. 

Modifying Coior Printers 

A new feature of SharedPrint/UX optimizes the printing of highly-detailed 
color graphics (such as scanned photographs) on these hve printers: 

■ PaintJet XL300 

■ DeskJet 500C 

■ DeskJet 550C 

■ DeskJet 560C 

■ DeskJet 1200C 

If you have not conhgured or reconhgured one of these printers at this version 
of SharedPrint/UX, no action is required. See “Enabling SharedPrint/UX on a 
System” at the end of this chapter. 

Otherwise, follow these guidelines for the best color graphics printouts: 

1. Enable SharedPrint/UX on this system by entering this command: 

/opt/sharedprint/bin/sp_enable 

2. If the printer always has HP Special paper loaded, skip to step 3. Whenever 
other paper is used, modify the printer’s conhguration hie as follows: 

a. On the SharedPrint/UX server, click the Printer control in the front 
panel. 

b. Choose Conhguration Piles from the Administer menu. 

c. Select the appropriate printer name. 

d. Reset media_type to another media type shown in the hie. 

e. Save and exit the hie. 

3. Eor users who mainly print simple color graphics (such as screen dumps or 
simply-colored bar charts), suggest that they deselect Color Correct on the 
Graphics Options window of SharedPrint/UX. 

4. Eor users who mainly print highly-detailed color graphics (such as scanned 
photographs), users should leave Color Correct selected and leave the 
Gamma Value blank (the defaults for both options). 
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Printing in Europe 

In Europe, most SharedPrint/UX users require the HP_Roman_8 symbol set and 
a4 paper size which are not the default values. While each individual user can 
set these defaults values via the GUI, you can change the defaults for all users: 

1. Become root on the SharedPrint/UX server that controls the printer. 

2. Enable SharedPrint/UX on this system by entering this command: 

/opt/sharedprint/bin/sp_enable 

3. Click on the front panel printer control to display the SharedPrint/UX- 
Manager. 

4. Erom the Administer menu, select Configuration Files ... 

5. Select a printer name. 

6. Reset symbol_set to: HP_Roman_8 

7. Reset papersize to: a4 

8. Save and exit the hie. 

9. Eor each printer, repeat from step 3. 

Aiternative to setup pr 

If the system you are using has no X display, use these steps in place of the 
setup_pr script: 

1. Check that NCS or HP DCE/9000 is set up on your network by entering 
this command. 

/opt/sharedprint/lbin/splistpr -glbd 

If you receive a message that NCS or DCE is not set up, you need to set up 
either NCS or HP DCE/9000 on your network. See Appendix C, “Meeting 
NCS or DCE Requirements.” 

When no errors result from this command, continue with the next step. 

2. Change to the /opt/sharedprint/lbin directory. 
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3. Choose an appropriate printer model number from a list you display with 
this command: 

. /list_tmplt.sh 

■ Select PS if the printer only accepts PostScript input. 

■ Select a different model if the printer handles multiple types of hies. 

4. Add the printer to the system and the SharedPrint/UX database by 
entering this command: 

./add_printer. sh printer_name model_number io_port 

■ printer_name is any name you assign, up to 14 characters long. 

■ model_number is a printer model number displayed by list_tmplt. sh. 

■ io_port applies only for local printers - choose one of these device 
hlenames which identify the port on the rear of the system: 

/dev/ptr_rs232_a (Port ttya) 

/dev/ptr_rs232_b (Port ttyb) 

/dev/ptr_tek (Parallel port connecting a Tektronix 4693DX printer) 
/dev/ptr_parallel (Parallel port) 

5. For a serial printer, set the system’s serial line parameters by entering a 
command with this format: 

. /set_tty. sh io_port speed 

where: 

■ io_port is the io_port you used for add_printer. sh. 

■ speed is the baud rate for running the printer. 

For example, for a printer with an io_port of /dev/ptr_rs232_a and a baud 
rate of 19200, you enter: 

./set_tty.sh /dev/ptr_rs232_a 19200 

6. If this is a parallel printer, add the following line to the /etc/inittab hie: 

Ip: 2: once:/usr/bin/slp -r /dev/ device-filename 2>/dev/null 

For device-filename, supply the appropriate hie name. 
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7. When all printers are configured, see “Enabling SharedPrint/UX on a 
System” at the end of this chapter. 


Adding Remote SharedPrint/UX Printers 

1. Log on to the SharedPrint/UX server where you configured the printer for 
SharedPrint/UX. 

2. Note down the exact printer name(s) displayed by this command: 

/opt/sharedprint/lbin/splistpr -lisp 

No output means no printers are configured for SharedPrint/UX. 

3. On the client system, become root. 

4. Run sam and respond to the prompts as follows: 

a. Choose Printers and Plotters, then Printers/Plotters. 

b. If sam lists a printer that you planned to add, you must use sam 
to remove it first. (In Step c, you will add it back for use by both 
SharedPrint/UX and Ip.) 

c. From the Actions menu, choose Add a Remote Printer/Plotter and 
enter the following in these fields: 

Printer Name - Enter the printer name you found in step 2. 

Remote System Name - Enter the name (or IP address) of the system 
that is the SharedPrint/UX server. 

Remote Printer Name - Enter the same name you entered for Printer 
name. 

d. Repeat Steps b and c for each printer you want to use. 

e. Optionally, make a printer you added the default system printer. 


Note If you plan to print HP Help screens, choose a LaserJet Series 

III (or later) printer as the default system printer. That printer 
does not need to be a SharedPrint/UX printer. 


f. Exit sam. 
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5. When all printers are configured, see “Enabling SharedPrint/UX on a 
System,” which follows. 


Enabling SharedPrint/UX on a System 

Once you have access to one or more SharedPrint/UX printers (either local or 
remote), you need to enable SharedPrint/UX on each system where you plan to 
print. On each system, become root and execute the following command: 

/opt/sharedprint/bin/sp_enable 

If you later decide to return a specific system to the non-SharedPrint/UX 
method of printing, issue this command on that system: 

/opt/sharedprint/bin/sp_disable 

After using this command, the SP-labeled printers in the Printers subpanel 
no longer accept print requests. To remove these printers from the subpanel, 
restart the VUE Window Manager. 
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Using SharedPrint/UX 


Once you have set up SharedPrint/UX printers on a system, you can use this 
chapter to get started start printing various text and graphics hies. See the 
following topics covered in this chapter: 

■ Printing Files 

■ Checking Print Status 

■ Saving Common Print Setups 

■ Getting Help with SharedPrint/UX 


Printing Files 

You can print from HP VUE or from the UNIX command line once you have 
access to SharedPrint/UX printers. However, if you have not yet enabled 
SharedPrint/UX on your system, become root and issue this command: 

/opt/sharedprint/bin/sp_enable 


Printing From HP VUE 

1. Display the SharedPrint/UX window by choosing one of these actions: 

■ Drop a hie icon on the Printer control in the HP VUE Front Panel. 

■ Or, select a hie in File Manager, then select Print from the Actions 
menu. 


Note After adding a printer, the hrst attempt to display the 

SharedPrint/UX window may result in a one-minute delay; 
afterwards, performance becomes normal. 
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2. On the SharedPrint/UX window that appears, select the printer you want 
by clicking the Printers button. 

3. Type the number of copies you want in the Copies held. 

4. Change other print controls and hll in text helds, if needed; use the Help 
button for details. 

5. Choose OK to print the hie. 

6. To conhrm the hie is printing, choose the Printer control in the HP VUE 
Front Panel. The SharedPrint/UX Manager displays all print requests in 
the queue. 

OK versus Print 

When you choose OK to print, SharedPrint/UX saves your selections for 
controls (buttons and helds) as the defaults for your next print request. 

If you choose Print to print, only the current print request uses these 
selections. Also, the SharedPrint/UX window remains displayed; the Close 
button dismisses it. 

Printing from the UNIX Command Line 

To access SharedPrint/UX at the HP-UX command line, use this command: 

/opt/sharedprint/bin/sprint [x-options] [-p printer] [filename {-post, 
-no_post}] 

For further details on this command, type: man sprint. 

The alternative command line method is to use the IP command with the -o 
option. Use the options described in Appendix A. 
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Checking Print Status 

To invoke the SharedPrint/UX Manager, click on the printer control in the 
front panel. A Graphical User Interface appears and displays menus for 
checking the status of printers and print requests and administering the 
SharedPrint/UX system. 

Accessing SharedPrint/UX Manager at the Command Line 

To access the SharedPrint/UX Manager at the HP-UX command line, use this 
command: 

/opt/sharedprint/bin/spadmin 

For further details on this command, type: man spadmin. 


Saving Common Print Setups 

After setting up a print request by selecting options and Filing in fields, you 
can save the current print setup for use in future print requests. Your saved 
print setup is called a Virtual Printer, a specific printer plus the combination 
of the options you selected. The Virtual Printer appears in the Printers list, 
so you can reapply these options to other hies. 

For instance, you may frequently set up SharedPrint/UX to print draft quality 
output. To be able to reuse what you enter for options, you would perform 
these steps: 

1. On each SharedPrint/UX window, set the buttons and enter values as 
needed for your print request. 

2. Click on Virtual Printer on the first SharedPrint/UX window. 

3. Under Add Virtual Printer, enter a name that reminds you of these print 
settings. For instance, enter draft if they apply to draft output. 

4. Press Return. 

5. Select Close. 

6. Select Printers to confirm your virtual printer is now in the list. 
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Before creating a Virtual Printer, you may wish to test your print request to 
check that it provides the output you want. Because SharedPrint/UX saves the 
last used settings, the next time you enter SharedPrint/UX, you can hne-tune 
your settings or values and then create the Virtual Printer. 

For more details on Virtual Printers, click on the Help button on the Virtual 
Printers window. 


Getting Help With SharedPrint/UX 

From within SharedPrint/UX and the SharedPrint/UX Manager you can use 
the Help buttons to display information that applies to the current window or 
task. 

You can also preview the help windows before starting SharedPrint/UX. Use 
these steps: 

1. Click on the Help control, shown as a Bookcase symbol in the HP VUE 
front panel. A window appears listing entries for all help on the system. 

2. Scroll down to where you see SharedPrint/UX. 

3. Click on SharedPrint/UX to select it. A window appears with two entries 
that you can select: 

■ SharedPrint/UX 

■ SharedPrint/UX Manager 
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Printing Multiple Files and Silent Printing 

If you added a SharedPrint/UX printer to your subpanel, you see an SP 
labeled on the printer icon. To print one or more files on that printer, drop 
the hle(s) on that printer icon. This action prints the hle(s) with the last 
SharedPrint/UX options you used. This printing is called silent printing, 
because the SharedPrint/UX dialog does not appear. 

You can also use the Printers subpanel to obtain the status of printers. Click 
an SP printer to display the SharedPrint/UX Manager showing the state of 
your printers. 


Printing or Saving Screen Images 

From the SharedPrint/UX dialog, you can choose Capture Screen to print: 

■ A window 

■ A screen region 

■ The whole screen 

Respond to the prompts to capture the image and then select a printer that 
can print bitmap images. 

If you want to save a screen image in a hie, you can use the HP-UX Capture 
tool. Capture lets you capture a screen image and save it in a hie in either 
XWD format or a compressed TIFF format you choose to save disk space. 

The Capture tool is in the Media Toolbox in the General Toolbox. 

For more details on printing or saving a screen image, choose the Help button 
on the Capture Screen window. 
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Understanding the SharedPrint/UX 
Architecture 


The spooling system interface for HP-UX is based on the System V Ip 
spooling system. This system uses a shell script to process a print request. 
SharedPrint/UX does not modify the Ip spooler functionality, but adds the 
print_model.sh shell script to process spooled requests. 

This chapter covers the following topics that explain how SharedPrint/UX and 
its print_model.sh script interact with the HP-UX spooling system: 

■ The HP-UX Spooling System 

■ The print_model.sh Shell Script 

■ Conhguration Files 

■ Filter Design Needs 

■ Driver Design Needs 


The HP-UX Spooling System 

The HP-UX spooling system consists of the following two phases: 

■ Communications phase 

■ Processing phase 

During these phases, the Ip command and Ipsched daemon use the hies and 
directories created by Ipadmin to process the request. The following sections 
describe the communications and processing phases and provide details about 
how the Ip command gathers the information required to process the request. 
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Communications Phase 


The communications phase begins when the user makes a print request with 
the Ip command. During the communications phase, Ip creates the data and 
control hies in the /var/spool/lp/request/prmter_name directory, where 
printer_name is the name of the printer specihed for this request. Then, a 
child process spawned by the Line Printer scheduling daemon (Ipsched) opens a 
streams connection to the data and control hies. The communications phase 
involves the Ip command and the Ipsched daemon. 

Processing Phase 

The processing phase begins when the Ipsched child process executes the 
interface program and ends when the hie is printed. During the processing 
phase, Ipsched opens the output device (usually a printer), reads and executes 
the interface program, and deletes the data and control hies. The processing 
phase involves the Ipsched daemon and the interface program. 

After deleting the data and control hies for the current request, Ipsched rescans 
the appropriate /var/spool/lp/request/prmter_name directory for a control hie 
belonging to another request. If it hnds another control hie, it repeats the steps 
to process the request. The Ipsched daemon repeats the get request - process 
request loop until it hnds no more control hies for this printer. 

How Ip Creates the Control File 

When a user invokes the Ip command to submit a request to the printer. Ip 
creates two hies for each request: the data hie, which contains the data to be 
printed, and the control hie, which contains information about how to process 
the data hie. There are three sources of information for the control hie: the 
options specihed in the Ip command, the environment variables of the process 
that executes Ip, and the printing system conhguration. In some cases. Ip must 
use all three sources to obtain the required information. 
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The print_model.sh Shell Script 

The print_model.sh shell script, which is also referred to as the 
SharedPrint/UX model script, is the interface program invoked by the Ipsched 
print daemon when a print request is processed. The script is found in 
/opt/sharedprint/lbin and is called with the following arguments: 

■ job_id 

u user_name 

■ title 

■ copies 
u options 

■ files 

The hrst four arguments represent the request number, user who queued the 
request, print request title, and number of copies to be printed. The options 
argument contains zero or more tokens, each representing an option specihed 
by the user who queued the request. These options are set on the Ip command 
line by preceding the option string with the letter o. The SharedPrint/UX 
graphical user interface includes menu items to select and set each of these 
options. The files argument is a list of one or more hies to be printed. 

The print _model.sh script serves all the supported printers by dynamically 
conhguring itself for each print request. The information needed for this 
operation comes from a set of hies that can be modihed as required. Each 
printer requires a unique printer conhguration hie that is customized to that 
printer. This hie is created when a printer is added to the system. It can be 
modihed by selecting Configuration Files . .. from the Administer menu of 
the SharedPrint/UX Manager. In the /opt/sharedprint/bin directory, the 
command spadmin starts the SharedPrint/UX Manager. 

The print_model.sh script is a Korn shell script that makes extensive use of 
shell variables to control the print request process. The script invokes control 
programs to perform some of the process and information gathering tasks. 

Each control program expects a certain set of inputs. The print script provides 
these inputs as global shell variables. In addition to the control programs, the 
script invokes filter programs to perform the actual translation and formatting 
steps. 
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The following 5 steps form the basic procedure for each request: 

1. Determine the printer type 

2. Build an options list for the request 

3. Determine the hie type 

4. Build a hlter pipeline to process the request 

5. Execute the hlter pipeline 

Figure 4-1 illustrates the how of print_model.sh, and its use of conhguration 
hies. It is followed by sections that describe each block in the how chart. 


4-4 
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Configuration Fiies 


Sheii Script 


none 


Printer configuration file 
Types file 


Printer configuration file 
Options file 


Printer configuration file 
Patterns file 

Object name extensions file 
Types file 

Pipeline file 
Filter options file 
Printer configuration file 


Printer configuration file 



Figure 4-1. pnni^model.sh Shell Script 
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Parse Command Line 

The Parse Command Line function (parse_cmdline) reads the command line 
arguments and converts them to the shell variables used by the remaining 
portion of the script. The main purpose of this function is to enclose the 
specihcs of a spooling system in one location. 

For the HP-UX spooling system, this function hrst strips the printer name off 
the request_id argument. It builds the printer conhguration hie name from this 
printer name. The format of the hlename is printer_name.'pci, and the hie is 
stored in the directory /etc/opt/sharedprint. If the conhguration hie does not 
exist, the script disables this printer, attempts to print an error page and exits. 
Each of the remaining command line arguments is copied to shell variables. 

Get Printer Type 

The Get Printer Type function (get_printer_info) determines which hie type 
or types are supported by this printer. This function requires the printer 
conhguration hie name as input, and sets the shell variable OUTTYPE as 
an output parameter. If multiple hie types are supported by the printer, the 
variable OUTTYPE contains each of the type strings separated by a : (colon). 

The printer conhguration hie dehnes the printer type or types; this hie is 
created when a printer is added to the Ip spooling system. The conhguration 
hie Types.cf lists the supported hie types. The get_printer_info function scans 
the conhguration hie for this entry, and builds the output type string. If no hie 
type entry exists in the conhguration hie or the conhguration hie cannot be 
located, an error page is sent to the printer, the printer is disabled, and a mail 
message is sent to the user who made the print request. 

If the user has specihed a pipeline, this function is ignored. 

Build Options 

The Build Options function (build_options) builds a list of options from a set 
of defaults dehned in the printer conhguration hie and the options passed by 
the user. All options are dehned in Appendix A of this manual. 

The inputs for the Build Options function are the printer conhguration hie 
name, command line options, and command line copies variable. This function 
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writes a shell variable called OPTIONS, which is a list of options and their 
values. The format of each item in the list is OPTION=VALUE, with each 
item separated by newlines. 

The Build Options function parses each token in the options variable, checks 
the hie Options.cf for the correct spelling, and stores the option and its value. 
After parsing the last token in the options variable, the build_options function 
reads directives from the printer conhguration hie. If a directive was already 
set by the options variable, the printer conhguration hie value is ignored. If a 
directive was not already set, it is added to the options list. When the printer 
conhguration hie is completely parsed, the options list is copied to the shell 
variable named OPTIONS. 

When a user option or an option in the printer conhguration hie is absent 
from the Options.cf hie, that option is added to the options list without being 
modihed. 

Options on the Ip command line must be preceded with a — (minus sign). To 
pass multiple options to print_model.sh, use the following syntax: 

Ip -o“-optionl vail -opt2 val2 ...” 

If an option has no associated value, it is treated as TRUE or ON. All option 
strings are lower case. 

The maximum option string that can be passed with the Ip -o option is 512 
bytes. Scripts that build long command lines should use one of the alias names 
dehned in the Options.cf hie. 

Front Banner Page 

The Eront Banner Page function (print_banner) creates a banner page hie, 
then calls the print script to send it to the printer. Thus, any type of banner 
page can be sent to any printer. SharedPrint/UX includes a banner page 
program for PostScript, PCL4, and ASCII text. 

The banner pages are modeled on the standard banner produced by the Ip 
print scripts. 

Table 4-1 shows the format for the banner page. 
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Table 4-1. Banner Page Formatting Features 


Feature 

units high 

Filled region (maybe text ) 

3 

white space 

2 

user name 

4 

white space 

2 

full user name from /etc/passwd 

1 

white space 

1 

request id: printer name: 

1 

white space 

1 

date & time 

1 

white space 

2 

title 

4 

white space 

2 

filled region (possibly text) 

3 


The basic flow of this function follows: 

1. Check if the front banner is in the Configuration file. Exit, if no entry. 

2. Check if the user has specified the -banner off option. Exit, if this is TRUE. 

3. Execute the banner script or program and write the output to a file named 
/etc/opt / sharedprint/banner .prmter_ name 

4. Call print_model.sh, passing the file produced by the banner script. 

5. Delete the file banner. printer_name 

The module that produces the banner page can be a script or a program. In 
either case, it expects the user name and title as input. The module writes the 
output to standard output. The banner function redirects stdont to the banner 
file. 
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Get File Type 

The Get File Type function (get_file_type) determines the hie type of the 
spooled hie. The hie types supported by this model are listed in the print 
script conhguration hie file_types. The hie type is necessary to determine what 
if any processing is necessary so that the content is correctly formatted for the 
target printer. For instance, a PostScript hie must be converted to PCL to 
print on a LaserJet printer. 

The hie typing checking process uses three methods in the following order: 

1. Command Line Option 

2. File Type Reader 

3. File Extension Value 

When a match is found, the type checking process terminates. The matched 
string is compared to values in the types hie in case the string is an alias. The 
shell variable INTYPE is then set to the hie type value. 

If the hie type can not be determined from any of the above methods, an error 
page is printed, and the request is aborted. 

If the user has specihed a pipeline, the Get File Type function is ignored. 

The Get File Type function is a shell script that calls other shell scripts and 
binary programs. The input to this function is a hie name and options variable. 
If this function is successful, it sets the variable INTYPE and returns with an 
exit status of 0. If unsuccessful, the script creates and prints an error page and 
the function returns a status code of 1. 

The following sections provide detail on the individual functions within the Get 
File Type script. 

Command line option 

If the user includes the -file_type option on the command line, the hie type 
value will be set to the value following -file_type. If the value following 
file type is not listed in the file Types.cf, the value is used as is. This handles 
the situation of the pipeline file having an entry for the file type, but Types.cf 
has no entry. 
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File Type Reader 

The File Type Reader function compares the hie contents with a predehned set 
of patterns for specihc hie types. These patterns are coded as C programs or 
Korn shell scripts in the /opt/sharedprint/bin directory. Each program or 
script expects a hie as input. If the hie type matches the dehned pattern, the 
program or script writes the type string to standard output, and returns an 
exit code of 0. If no match results, the program or script returns an exit code 
of 1. 

A special hie type program is based on the HP-UX Image Library. If the Image 
Library can process the hie, the hie type program writes the string bitmap to 
standard output, and exits with a status code of 0. 

The overall hie type reader is a function that executes each of the programs or 
scripts in the filetypes directory until a match is found. If all the programs or 
directories are called and no match is found, this function exits with a status of 

1 . 

File Extension Value 

The File extension value function (get_file_type_by_ext) checks the extension 
(suffix) of the hlename. The function extracts the extension value (the string 
following the .) from the title argument and maps it to a hie type via the hie 

ObjNamExt.cf. 

Build Pipeline 

The Build Pipeline function (build_pipeline ) starts by checking to see if the 
user has specihed a pipeline. If a pipeline is not specihed, this function scans 
the Pipeline.cf hie which maps the input hie type to the printer hie types. 

At each intersection, a set of hlters is dehned to perform the translation. If 
no hltering is necessary, the table entry becomes a null string. If no entry is 
found for the specihed input and output types, an error page is printed and the 
request is aborted. 

The pipeline is completed by adding a driver function to the hlter pipeline. 

The driver is determined from the printer conhguration hie. The pipeline string 
at this point has the format filter 1 \filter2\driver. Note that each filter ... 
string can be a hlter name followed by some options that control how the hlter 
is executed. 
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Next, the executable script is created by adding the appropriate options to 
each of the hlter and driver elements. The hie OptionsMap.cf maps the 
options that apply to each hlter or driver, so that the correct arguments are 
passed to the actual hlters. Thus, the hnal pipeline string has the following 
format: 

filter 1 -ol V -o2 v -o3 v\filter2\driver -ol v 

If the standard options string does not match the hlter options string, the hlter 
options map includes a translation string with the following syntax: 

filter name=optionl:options2(filter options string):options3 

The Build Pipeline function replaces the standard options string with the 
filter-specific string. 

Execute Pipeline 

The Execute Pipeline function (execute_pipeline ) executes the pipeline created 
in the Build Pipeline function. Output from the last stage is sent to standard 
output, which is the I/O connection to the printer. Multiple copies may cause 
the pipeline to be executed multiple times. This may not happen if the printer 
can be directed to perform the multiple copies operation. 

If an error occurs in any of the filter or driver elements, the error is captured 
and an error page is printed. 

The execute_pipeline routine uses the nice command to assign a low CPU 
priority to print requests. If you want SharedPrint/UX to devote more CPU 
time to print requests, edit the print .model. sh script to change the use of this 
command. See the nice man page for more details. 

Last Copy 

The Last Copy function checks if the pipeline must be reexecuted because 
another copy is needed. 
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Last File 


The Last File function cycles the script back to processing the next request. 

The initial state of the options, printer conhguration hie, and output type 
remain the same and do not need to be recalculated. 

Rear Banner Page 

The Rear Banner Page function is the same function used to print the front 
banner page (print_banner). It may be used to print a short trailer or for 
requests on printers that print face up. 

Error Page Function 

The Error Page function (print_error ) is called when some unrecoverable 
event occurs. The hie error\og.printer_name contains all output from 
print_model.sh. Each function or hlter is expected to write all error or warning 
messages to standard error. print_model.sh redirects these messages to the 
error log. If print_model.sh detects an unrecoverable error, the contents of this 
hie are sent as a request to the print script, in the same way the banner page is 
printed. 

Anytime a hlter or driver writes to stderr, an error page is printed. To turn 
off the error page printing function, add the directive NoErrorPage to the 
conhguration hie for that printer. 


Configuration Files 

This section dehnes the hies used by the print_model.sh script to process 
print requests. A copy of each hie is included in SharedPrint/UX. These 
conhguration hies provide all the information required to process any supported 
hie type on any supported printer. 

Users can modify these hies using an editor, or in the case of the printer 
conhguration hies, by using the SharedPrint/UX Manager. In all cases, an item 
in one of the hies can be continued on the next line by placing a \ (backslash) 
at the end of the line. No blank space or other characters must follow the 
backslash. 
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printer model files - These files are templates that contain information for 
a specific model of printer. The information in each file includes options 
supported by this printer, default values for any filters that may be used with 
this printer, default interface settings, and file types which this printer can 
handle. The format is option=value or if an option supports multiple values 
the format is option=valuel:value2: 

These files are stored in /opt/sharedprint/lib/printers. 

printer configuration files - These files each contain information about an 
individual printer. The file is created from one of the printer model files 
when a printer is added to the system. Users can modify this file to reflect 
changes made to the printer, such a swapping paper trays or inserting font 
cartridges. Changes are used at the next print request. The format for each 
item in the file is option_name=vall:val2. 

These files are stored in the /etc/opt/sharedprint directory. 

types file - This file lists the supported file types and alias strings for each 
type. The format of each entry in the file is type_string:aliasl:alias2, where 
type_string is the entry used in other configuration files that contain file type 
references. 

This file is stored as Types.cf in the /opt/sharedprint/lib/config directory. 

object name extension file - This file contains a list of entries that map file 
extension values to file types. A file extension value is the component of a 
pathname that follows the . (period). The format for each item in the file is 
extension_string=file_type . 

This file is stored as ObjNamExt.cf in the /opt/sharedprint/lib/config 

directory. 

pipeline file - This file specifies a filter pipeline for each 
combination of input file type and output file type. The format is 
INTYPE:OUTTYPE=filterl\filter2. Each of the filter specifications can 
include options and white space. 

This file is stored as Pipeline.cf in the /opt/sharedprint/lib/config directory. 
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■ filter options file - This file lists the supported options for each filter 
or driver. The format is filter_name=option:option(filter specific 
spelling)-.option. 

This file is OptionsMap.cf in the /opt/sharedprint/lib/conlig directory. 

■ options file - This file lists the known options and aliases. The format is 
option: alias: alias. 

This file is stored as Options.cf in the /opt/sharedprint/lib/conlig directory. 

Filter Design Needs 

Each filter reads from standard input and writes to standard output. Error, 
warning and information messages should be written to standard error. All 
arguments to the filter must be optional. Built-in defaults should handle any 
arguments not passed to the filter. 

Driver Design Needs 

Each driver reads from standard input and writes to standard output. Error, 
warning, and information messages should be written to standard error. All 
arguments to the driver must be optional. Built-in defaults should handle any 
arguments not passed to the driver. 

In most cases, the driver sends a header containing any request control 
information such as language switching commands for HP LaserJet IllSi, then 
passes the input stream to the output stream. In some cases, the driver should 
examine the first few bytes of a file to check for any reset control characters 
that could interfere with the driver header stream. Eor instance, PCL files may 
contain an ESC E, which resets the printer state. The driver must strip these 
bytes if the header must be sent. 
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Using SharedPrint/UX Filters 


The directory /opt/sharedprint/bin contains the SharedPrint/UX hlters. 
These hlters are programs that operate on data, producing resultant data with 
different characteristics. SharedPrint/UX has two types of hlters: 

■ translators - hlters that change the encoding of the information in the data 
hie without changing its appearance. 

For example, a translator may convert text to PostScript format. 

■ formatters - hlters that modify how the information in the data hie is 
rendered on the page. 

For example, a formatter might rotate or scale an image, add commands 
for multi-column text printing or add footers and headers to a document. 
These hlters often have options that the user can set to control the hnal 
appearance. 

Filters are invoked by the print_model.sh script working with the Filter Pipe 
Builder function described in Chapter 4. Each hlter reads from standard input 
and writes to standard output with error messages being sent to standard 
error. 

The SharedPrint/UX hlters are illustrated in Figure 5-1. 
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BITMAP FILTERS 



Figure 5-1. The SharedPrint/UX Filters 

This chapter explains these hlters under the following headings: 

■ Text Filters 

■ CGM Filter 

■ PCL Page Description Language Filter 

■ Image Library Filter 


Text Filters 

The txpcl and txps hlters format and translate text documents into PCL and 
PostScript, respectively. As Table 5-1 shows, formatting options enable users 
to change point size, print portrait or landscape, choose double-columns, add 
headers and footers, and change typeface and symbol set mapping. 
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Table 5-1. txpci and txps Filter Formatting Options 

Option 

Description 

orientation 

columns 

margins 

header 

footer 

wrap 

page reverse 

collate 
symbol set 
point 

Ipi 

select landscape or portrait layout 
select one (1) or two (2) columns 

set top, left, right, bottom margin to a specified measurement 
specify a header string to place at the top of the page 
specify a footer string to place at the bottom of the page 
wrap text which exceeds the right margin to the next line 
output the pages in last-page-first order 
collate multiple page documents 
specify the symbol set mapping 

specify the height of the text in points. One (1) point=l/72 inch, 
specify the line spacing in lines per inch 

PCL-specific options are: 

typeface 

weight 

spacing 

pitch 

style 

specify the font design to be used to print the document 

specify the font weight 

specify proportional or fixed width font 

specify the inter-character spacing in lines per inch 

specify upright or italic printing 


Using the SharedPrint/UX Graphical User Interface 
(/opt/sharedprint/bin/sprint) you can set up options, saving them 
as Virtual Printers for reuse in print requests. 

Not all combinations of options can be satished. The hlters attempt to match 
the required attributes to the closest available font on the target printer. 
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Options that have conflicting requirements are resolved in this order of priority: 

orientation 

symbol_set 

style 

spacing 

point 

pitch 

weight 

typeface 


These Alters process the following control characters (ASCII code in 
parenthesis): 

backspace Insert a bold character at the preceding position if the next 

(0x08) character is the same. Add an underline to the preceding 

character if the next character is an underscore. Overlay the 
preceding character with the next character if the characters do 
not match 


tab (0x09) 
If (OxOA) 
cr (OxOD) 
If (OxOC) 


Replace the tab character with spaces up to the next stop. 
Move the current text position to the start of the next line. 
Overlay the previous line and the next line. 

Finish the current page and begin a new page. 


Text to PCL Filter 

The txpcl (text to PCL) Alter supports all PCL3, PCL4, and PCL5 devices. 
The core of the Alter is independent of the printer type. The printer or PCL 
level speciAc information is resolved by code which selects the font to be used 
to print the document. It is based on the model name speciAed in the printer 
conAguration Ale. 

The font metric information is read from a set of Tagged Font Metrics (TFM) 
Ales that are included with this product. Every internal font for all the 
supported printers is represented by a TFM Ale. Support for font cartridges is 
not included. 
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Text to PostScript Filter 

The txps (text to PostScript ®) filter supports all level 1 (initial PostScript 
release) and level 2 PostScript devices. 

The font metrics used by this filter are stored internally and are limited to 
courier typefaces. An external set of files is used to define PostScript code used 
to remap the existing symbol sets. SharedPrint/UX includes a symbol set 
mapping for the Latin-1 character set. 

For each encoding file, the file name corresponds to the symbol set name on the 
Ip command line or SharedPrint/UX Graphical User Interface. For example, 
if the user specifies -symboUset ISO_100, the file ISO_100 in the directory 
/opt/sharedprint/filters/afm is used to build the encoding vector. The 
encoding vector specifies how character codes are mapped to character glyphs. 

Two types of entries are found in these encoding files. The first type of entry 
maps a glyph name to a character code. For example, the ASCII character 
code 156 would produce a pound sterling symbol on the page. 

156 / £ 

The second type of entry defines a PostScript procedure to create a character. 
Typically, these entries are composite characters that have no predefined glyphs 
that are printer-resident or glyphs that come from the symbol font. This 
example shows how to create the 3/4 character and map it to character code 

190: 

190 {0.5 0.5 si 0 200 tl (3) hfc 400 100 ng tl (/) hfc 400 100 ng tl (4) hfc} 
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The following PostScript procedures are predefined as an aid in creating new 
character procedures: 


/in {72 mul} def 
/sh {show} def 
/mt {moveto} def 
/tl {translate} def 
/ng {1 neg mul} def 
/si {scale} def 

/hf &/ Courier findfont 1000 scalefont def 
/hfc {hf setfont 0 0 moveto show} def 
/hs &/ Symbol findfont 1000 scalefont def 
/hsc {hs setfont 0 0 moveto show} def 


CGM Filter 

The cgmhpgl2 (CGM to HP-GL/2) hlter reads a binary CGM hie and produces 
an HP-GL/2 byte stream. It is used to obtain 2D graphics output from 
Starbase or HP-PHIGS CGM hies. Other CGM hies also correctly plot if the 
CGM hie conforms to the CGM application prohle specihed in Appendix B. 

Not supported by these hlters are the CGM clear text and character encodings. 
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The following options are supported by this hlter: 

fitpage Forces the plot to ht on the page as best as possible. 

orientation Specifying portrait forces the image to be rotated 90 degrees 

on the paper. Normally, the plot is oriented so that the long 
axis is the paper is plotted as the x axis. 

pen_color Specihes that the target device is a pen plotter. 

paperwidth Specihes the width of the output media in inches. 

paperlength Specihes the length of the output media in inches. 


PCL Page Description Language Filter 

The device Page Description Language (PDL) specihes the commands and data 
structures the printer can interpret to produce a page image. Most printers 
contain only a single PDL, but some printers can support multiple PDLs, 
usually by means of an escape sequence that informs the printer which PDL 
mode to use. 

Files that contain PDL commands supported by the target printer can be sent 
directly to the printer with no modihcation. Files with content that cannot be 
interpreted by the printer require the services of a PDL translator. 

Each translator reads the input hie and produces a raster image of the hies 
content. The raster image is then formatted further based on the target 
printer’s PDL. This approach allows users to queue hies created from various 
applications to any printer without the need to know about the printer’s PDL. 

PCL Filter Features 

The PCL PDL hlter reads PCL hies and creates a raster image for each page. 
This hlter can read PCL versions 1 through 4, except for PCL 3+ hies, but 
including Version 4 hies with the Version 5 scalable fonts. The raster image is 
fed to the formatter, which adds the appropriate control or command codes for 
the target device. Then, the formatted raster image is sent to the device driver 
where any additional job control information is added. 
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The PCL PDL filter requires the following information to create the raster 
image: 


resolution Specifies the target device dot spacing in dots per inch, 

paperwidth Specifies the width of the output media in inches, 

paperlength Specifies the length of the output media in inches. 

PCL Filter Limitations 

The PCL PDL filter has the following limitations: 

■ This filter converts characters with bitmap sizes of up to 64 KB. A 64 KB 
character is approximately 2.5 by 2.5 inches (at 300 dots per inch), or 7.5 by 
7.5 inches (at 100 dots per inch). The filter terminates with an error if the 
character is too large. 

■ HP-GL/2 commands are not supported; all HP-GL/2 commands are ignored. 
Therefore, graphic content can show up when the file is printed on an 
HP-GL/2 printer. 

■ This filter does not support PCL3-|- commands, the color commands used by 
the PaintJet, PaintJet XL, and DeskJet 500c. The PCL3-|- commands result 
in bitonal output. 

■ This filter may substitute a dilferent font from the font in PCL file in these 
situations: 

□ The currently selected font is an internal bitmap, cartridge bitmap, or 
cartridge scalable font and the print direction changes or selection of the 
primary or secondary fonts is attempted. 

□ The file contains a dingbat; this filter does not support Dingbat symbols. 

□ The PCL file fails to reselect a font after the return of a macro. If the PCL 
file shifts to primary or secondary font, but fails to reselect the original 
font, some characters may be lost. 
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■ This filter does not support the following commands in a PCL file: 

□ Simplex/Duplex: ESCAPE & I # s/S 

□ User Defined Logical Page: ESCAPE h a, w/W [LP definition] 

□ VEC (Vertical Eormat Control sequence) Support 

□ Source Transparency Mode: ESCAPE * v n/N 

□ Pattern Transparency Mode: ESCAPE * v o/O 

□ Select Pattern: ESCAPE * v ^ t/T 

□ User-Defined Patterns: ESCAPE * c ^ w/W [pattern data] 

□ Set Pattern Reference Point: ESCAPE * p # r/R 


Image Library Filter 

The ilFilter (Image Library) filter converts a well-known bitmap format, or a 
PCL 4 file into a PostScript or PCL file. The filter is composed of the following 
three stages: 

1. A producer converts the input object into an Image Library format. 

2. One or more filters manipulate the raster image. 

3. A consumer converts the Image Library image into a PostScript, or PCL 
file. 


Using SharedPrint/UX Filters 5-9 




The Image Library producers read a bitmap file and translate it to an Image 
Library format. In addition to the producers shown in figure 5-1, the EFS 
Image Library includes producers that accept the following formats: 

■ X window dumps 

■ Bitonal X bitmaps 

■ Color X pixmaps 

■ Starbase bitmaps 

■ TIFF 5.0 and TIFF JPEG 6.0 images 

■ JFIF images 

■ GIF images 

PostScript PDL Filter Raster 

The PostScript PDL raster producer takes a bitmap created by the PostScript 
PDL and feeds it to the Image Library pipeline. Translations can be added 
here as necessary to perform functions such as scaling or rotation. In general, 
this filter is used to feed one of the Image Library consumers. 

PCL PDL Filter Raster 

The PCL PDL raster producer feeds a bitmap produced by the PCL PDL filter 
to the Image Library pipeline. Additional filters can be added to the Image 
Library pipeline to perform scaling or rotation operations. In general, this filter 
is used to feed one of the Image Library consumers. 
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Image Library Consumers 

The Image Library consumers read an image from an Image Library pipeline 
and formats it for a specific device PDL. Figure 5-1 shows the following 
consumers: 

■ X-Windows (as an X bitmap) 

■ TIFF hies 

■ JFIF hies 

Postscript 

The PostScript Image Library consumer generates Level 1 PostScript. Color 
information is mapped to the Level 1 PostScript color commands. 

PCL 

This consumer generates PCL 3 or PCL4-|- code as directed by the printer 
conhguration hie. It prints up to the hrst 200 pages of the print request. 
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Extending SharedPrint/UX 


This chapter describes the three ways that SharedPrint/UX can be extended: 

■ Adding Support For An Unsupported Printer 

■ Adding Support For A New Filter 

■ Modifying Default SharedPrint/UX Behavior 


Adding Support For An Unsupported Printer 

To add support for an unsupported printer to SharedPrint/UX, perform the 
following steps: 

1. Write a new driver for the printer. 

This driver reads from standard input, writes to standard output, and sends 
error messages to standard error. The driver can choose to support any of 
the standard options or dehne some of its own. Place this driver in the 

/opt/sharedprint/lbin directory. 

2. Modify the pipeline hie Pipeline.cf, specifying hlter paths for your new 
printer from each of the hletypes you expect to support. 

3. Modify the OptionsMap.cf hie to specify which options are supported by 
your driver. 

4. Modify the Options.cf hie if you dehned any new options. 

5. Modify the Types.cf hie if you dehned any new types for your driver. 

6. Create a conhguration hie for your new printer. 

Make a copy of an existing template that contains elements that are the most 
similar to your printer’s capabilities; then, edit the copied template. The 


Extending SharedPrint/UX 6-1 




important items are the file^types directive and the driver directive. The 
file_types directive tells SharedPrint/UX which hie types this printer can 
handle. The driver directive should specify the driver you are creating or 
adding. 


Adding Support For A New Filter 

To add a new hlter to SharedPrint/UX, perform the following steps: 

1. Write a new hlter if needed; see the Chapter 4 section, Filter Design Needs. 

2. Modify the pipeline hie Pipeline.cf. Specify a hlter path for your new hlter 
for each combination of input and output types. 

3. Modify the OptionsMap.cf hie, identifying which options are supported by 
your hlter. 

4. Modify the Options.cf hie if you dehned any new options. 

5. Modify the Types.cf hie if you dehned any new types for your hlter. 
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Modifying Default SharedPrint/UX Behavior 

To modify the default behavior of SharedPrint/UX, perform the following 
steps: 

1. Modify the pipeline hie Pipeline.cf. 

Changing the order of the specihcations may cause different hlters to be 
used. For instance, if a printer supports PostScript and PCL, a text hie can 
be printed by using the txpcl or txps hlter. SharedPrint/UX uses the hrst 
specihcation encountered that performs the required translation. 

2. Modify the printer conhguration hie. 

You can change any of the default parameters. The default parameters 
are those used by the hlters and drivers if the user specihes no value. In 
addition, if the printer supports multiple types, changing the order of 
parameters can change which hlter is used when multiple print paths are 
available. 
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Troubleshooting SharedPrint/UX 


This chapter gives you information on what to do if problems occur during 
printing and on how to analyze error and debug pages. 


What To Do ... 

This section tells you what to do if any of the following situations occur: 

■ If nothing appears on the printer. 

■ If Network Computing System (NCS) errors appear. 

■ If GUI performance problems occur. 

■ If performance slows on servers with network printers. 

■ If problems occur on PostScript printers. 

■ If the output is a “PostScript Not Installed” page. 

■ If problems occur on large format plotters. 

■ If problems occur on LaserJet printers. 

■ If PCL fonts or symbols print incorrectly. 

■ If the wrong hie type is used. 

■ If you cannot print text in landscape mode. 

■ If you get an error message when printing from vuepad. 
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If nothing appears on the printer 

If you send print requests, but nothing appears on the printer, use the following 
steps: 

1. From the client system, check the print queue as follows: 

$ Ipstat -oprinter_name 

If Ipstat displays a warning, such as Warning printer^name is down, skip 
to Step 2. 

If Ipstat lists the print request in the queue, but the output does not 
eventually appear, check if the printer has the ONLINE button set to OFF 
or if it is out of paper. 

2. On the client system, check if the scheduler is running: 

$ Ipstat -r 

If the system displays scheduler is running, skip to Step 3. Otherwise, 
perform these steps: 

a. Login as root on the client system and start the scheduler as follows: 

$ /usr/lib/lpsched 

b. Check the printer status as follows: 

$ Ipstat -oprinter_name 

c. If the hie is not in the printer queue, use these commands on the client 
system: 

$ disable printer_name 
$ enable printer_name 
$ Ipstat -oprinter_name 

d. If Ipstat still does not show the hie in the printer queue, reissue the 
preceding commands on the server system. 

e. If Ipstat still does not show the hie in the printer queue, try Step 3. 

3. Assuming you are using a printer attached to another system, check if your 
system (the client system) can contact the system with the printer (the 
server system) across the network. On the client system, use this command: 
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$ /etc/ping server^name 64 2 

If this command issues information indicating 0% packet loss, the client can 
see the server. Skip to the Step 4. 

If /etc/ping issues an error, or a message indicating 100% packet loss, the 
client cannot see the server. To see the server, the client must either have 
named enabled or must list the server in the /etc/hosts hie. To correct this 
problem, use these steps: 

a. On the client system, check if named is enabled as follows: 

$ ps -e Igrep named 

If this command displays no output, named is not running. Skip to the 
step b. 

If named appears in the output, as in the following example (and 
/etc/ping did issue an error), your network may be experiencing 
problems. See your network administration documentation. 

$ ps -e Igrep named 
110 ? 0:52 named 

b. Search the hie /etc/hosts for the name of the server as follows: 

$ grep server_name /etc/hosts 

If this command displays no output, make the client known to the server 
using step c. 

If the command output shows the server name (and /etc/ping did issue 
an error), either the internet address in /etc/hosts is incorrect or the 
network may be experiencing problems. See your network administration 
documentation. 

c. To make the client known to the server, use either of the following steps: 

■ On the client system, add the correct internet address and the server 
name to /etc/hosts. This is the quickest step. 

■ Or, on the client system, enable named using the man page for named. 
This solution provides the same results for using SharedPrint/UX, but 
also provides other systems with easier access to the client system. 

Check that the client can now see the server as follows: 
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$ /etc/ping server^name 64 2 

If /etc/ping still issues an error, your network may be experiencing 
problems. 

4. If /etc/ping issued no errors, use these commands on the client system: 

$ disable printer_name 
$ enable printer_name 
$ Ipstat -oprinter_name 

5. If Ipstat still does not show the hie in the printer queue, perform these 
steps: 

a. Search the hie /etc/inetd.conf for the following line: 

ttprinter stream tcp nowait root /usr/lib/rlpdaemon rlpdaemon -i 

b. If the preceding line includes the # symbol as shown in column 1, remove 
this symbol. 

c. Save and exit this hie. 

d. Enable the rlpdaemon by executing the command: 

/etc/inetd -c 

6. On the client system, use SharedPrint/UX to submit a new print request. 

7. Check the print queue as follows: 

$ Ipstat -oprinter_name 

8. If none of the preceding steps corrected the problem, reboot the client 
system and resubmit the print request. 

If Network Computing System (NCS) errors appear 

Use this procedure if selecting a printer in SharedPrint/UX results in a 
message with the following text: Network Computing System or NCS 

1. If the SharedPrint/UX client is on a different system from the 

SharedPrint/UX server (the system with the attached printer you selected), 
check that the client can access the server. On the client, use this command 

$ /etc/ping server_system 64 2 

If this command issues information indicating 0% packet loss, the client can 
see the server. Skip to the Step 2. 
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If /etc/ping issues an error, or any message indicating 100% packet loss, 
the client cannot see the server. Network problems exist; see your network 
administrator documentation. 

2. On the client and the server system, check that either NCS or DCE is 
correctly set up. (Refer to Appendix C for NCS. For DCE, refer to the HP 
DCE/9000 documentation.) 

3. If the server is running and you still cannot print, check the llbd by issuing 
this command from the system with the printer attached. 

$ ps -e I grep llbd 

If this gives no output, perform these steps: 

a. Check the hie /etc/netncsrc for the following line: 

START_LLBD=0 

b. If this line is included, change it to the following line: 

START_LLBD=1 

c. Start the llbd by entering this command: 

/etc/ncs/llbd 

4. On the server system, issue the following command: 

$ ps -ef I grep spserver 

If the command output includes the text /opt/sharedprint/bin/spserver, 
kill the process. The following example illustrates this interaction. 

*/, ps -ef I grep spserver 

root 180 1 0 Oct 13 ? 0:00 /opt/sharedprint/bin/spserver 

•/. kill 180 

If the ps -ef I grep spserver command output does not include the text 
/opt/sharedprint/bin/spserver, perform these steps: 

a. Search the hie /etc/inittab for this line: 

ShPr::respawn:/opt/sharedprint/bin/spserver 

b. If this line is absent, add it to the hie. 

c. Start the SharedPrint/UX server using this command: 
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/opt/sharedprint/bin/spserver 

5. On the system with the printer attached, use SharedPrint/UX to submit a 
print request. 

6. If the print request succeeds, use the client system to submit the print 
request. 

7. If SharedPrint/UX fails on the client system, but works on the server 
system, use sam to reinstall the remote printer. 

If GUI performance problems occur 

If SharedPrint/UX GUI is slow to respond, the cause may be that the print 
server software has failed. Such a failure results in an orphaned entry in the 
NCS global location database, which can cause delays in processing print 
requests. 

To check if the server is no longer running, issue the following command: 

/opt/sharedprint/bin/splistpr -check 

If any entries show a — (minus sign) as shown in the following sample output, 
this indicates that this system may have failed or the print server software may 
no longer be running on it. 

status machine.name 
+ node_a 

+ node_b 

node_c 
+ node_d 

If you know one of these situations has occurred, you can correct the problem 
by issuing this command: 

/opt/sharedprint/bin/splistpr -delete -ma machine-name 


Caution Before issuing this command, be sure the system is not just 

temporarily offline. If the system comes back online after you 
issue this command, the server on it will be severely impaired 
and you will need to reboot that server. 
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The following example illustrates the use of the splistpr command. 

$ /opt/sharedprint/bin/splistpr -check 

status machine.name 
+ node_a 

+ node_b 

node_c 
+ node_d 

One or more SharedPrint/UX servers are down. If a 
SharedPrint/UX server machine is operational, and there is 
no spserver process on that machine, execute the command 
splistpr -delete machine_name, where machine_name is the 
name listed by splistpr -check 

$ /opt/sharedprint/bin/splistpr -delete -ma node_c 

SharedPrint/UX server removed from global database. 

$ /opt/sharedprint/bin/splistpr -check 

status machine_name 
+ node_a 

+ node_b 

+ node_d 


If performance slows on servers with 
network printers 

If performance slows on a server with a network printer, and you are printing 
images or PostScript hies, the timeout value on the printer may need 
adjustment. 

The manual provided with the printer describes how to adjust the timeout 
value on the network interface card in the printer. If the timeout value remains 
at the default setting, additional printing processes may be spawned every 90 
seconds until the print request completes. 
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If you are printing images or PostScript documents with an output page size of 
D or larger, try 1800 as the timeout value. 

If problems occur on PostScript printers 

If problems occur when you print a full-page bitmap image on a PostScript 
printer, the printer may need more memory. Up to 2 MB of memory may be 
required. 

If the output is a “PostScript Not Installed” page 

This message indicates you do not have a PostScript option installed on one of 
these printers: 

■ HP LaserJet IllSi 

■ HP PaintJet XL300 

■ HP DesignJet 650C 

■ HP DeskJet 1200C 

You need to modify the file_type dehnition in the printer_name.pc{ hie. Move 
the comment mark on the hrst line to the second line: 

#file_type=pcl5:hpgl2:pcl4:pcl3 
file_type=pcl5:hpgl2:postscript:pcl4:pcl3 


If problems occur on LaserJet printers 

If you print full-page images or PostScript hies on a LaserJet printer and a 
single-page output is split between two pages, the LaserJet may require more 
memory. Make sure the printer has 1 MB of memory. 

If problems occur on large format plotters 

If problems occur in printing images or PostScript documents on DesignJet or 
Electrostatic or other large format plotters, use these guidelines: 

■ If the print server shows excessive paging activity, you need to increase the 
amount of main memory on the server. At least 32 MB of main memory is 
needed for printing PostScript hies or images over C size. 
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■ If no output appears on the plotter or if you receive swap space errors, you 
need to increase the swap space on your system. See your HP-UX system 
administration tasks documentation. 

■ If you receive disk full error messages, the disk with the /usr/spool/lp 
directory has insufficient space for processing the print request. Consider 
moving /usr/spool/lp to a second disk and creating a link between the 
original and new /usr/spool/lp directories. 

If PCL fonts or symbols print incorrectly 

If some PCL print requests start using incorrect fonts or symbol sets, you 
may need to update some Xll Intellifont (AGFA) information. If a font or 
symbol set dehnition was added or removed from the system after installation 
of IMAGING-PCL, you must update the Xll information. To do so, issue this 
command: 

/opt/sharedprint/lib/imaging/pcl/update_pcl_fonts 

This script is executed automatically at installation of IMAGING-PCL, so you 
need to reexecute it only if you modify these font or symbol set dehnitions. 

If the wrong file type is used 

SharedPrint/UX can usually determine which type of hie the user is 
attempting to print. However, in some cases, it fails to detect the hie type or 
assigns an incorrect type. If the wrong output appears, see “Analyzing a debug 
page”. Using the the debug page, you can determine if the assigned hie type 
was incorrect. If so, resubmit the print request, using the file_type option on 
the Advanced Options window to set the input hie type. 

You cannot print text in landscape mode 

For three printers, printing text in landscape mode requires that you set the 
margins listed in the table below. 
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Margin Settings 


Printer 

Top 

Bottom 

Left 

Right 

Tektronix 4693DX 

0.2 

0.2 

1.7 

1.7 

Tektronix Phaser 

0.2 

0.2 

1.7 

1.7 

HP DeskJet 500C 

0.25 

0.25 

0.5 

0.5 


Analyzing Debug and Error Pages 

SharedPrint/UX provides the following printing tools that help you analyze 
printing problems: 

■ A debug page, created with each print request. 

■ An error page, created only if printing fails. 


Analyzing a debug page 

Every print request creates a debug page, a page of information that shows 
how the print request was processed. This page is stored in a hie named 

/ var/opt/sharedprint/debug . printername. 

If you want to print the debug page, reissue the Ip command with the syntax 
you used plus the PrintDebugPage option as follows: 

Ip -dprintername -o" PrintDebugPage other-options" filename 

The following is a sample debug page in a debug . printername hie. The 
meaning of each section of the page is described following the example. 


Debug information for job pjxl-358 


job owner = jones_c 
options = -resolution 90 

file(s) = /usr/spool/lp/request/pjxl/dA0358toast 

title = four_files 

Fri Jul 24 15:06:30 EDT 1992 

printer file type(s) = 
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pclSxl 

pcl3+ 

pcl3 

JOB_OPTIONS -copies 1 -resolution 90 -orientation portrait 

-papersize letter -top 0.25 -bottom 0.25 

-left 0.25 -right 0.25 -tab 8 -charheight 10.0 -columns 1 

wrap 1 -s 3 nnbolset 

ISO.lOO 

-page_reversal 1 -collate_copies 1 

processing " /usr/spool/lp/request/pjxl/dA0358toast" 
file type = bitmap 

pipeline = "ilFilter -p 3 -c 2 5 -resolution 90 -orientation 
portrait 

-papersize letter -top 0.25 -bottom 0.25 -left 0.25 -right 
0.25 I pjxl.sh 
-copies 1" 
end of job 

These lines identify the job id: 


Debug information for job pjxl-358 

This line identihes the job owner: 

job owner = jones_c 

This line shows the options passed to the Ip command from this application: 

options = -resolution 90 

This line lists the hies to be printed. In most cases, it is only one hie: 

file(s) = /usr/spool/lp/request/pjxl/dA0358toast 
This line shows the hlename: 

title = four_files 

This line identihes the date the print request was processed: 

Fri Jul 24 15:06:30 EDT 1992 

These lines list the hie types supported by this printer. Other hie types must 
be translated to one of these hie types. 

printer file type(s) = 
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pcl3xl 

pcl3+ 

pcl3 

These lines show command line and printer conhguration hie options: 

J0B_0PTI0IS -copies 1 -resolution 90 -orientation portrait 

-papersize letter -top 0.25 -bottom 0.25 

-left 0.25 -right 0.25 -tab 8 -charheight 10.0 -columns 1 

-wrap 1 -symbolset ISO_100 

-page_reversal 1 -collate_copies 1 

This line indicates which hie is being processed by the print request: 

processing "/usr/spool/lp/request/pjxl/dA0358toast" 

This line shows the hie type of the print request being processed. 

file type = bitmap 

These lines show the pipeline created by print .model. sh for this request: 

pipeline = "ilFilter -p 3 -c 2 5 -resolution 90 -orientation portrait 
-papersize letter -top 0.25 -bottom 0.25 -left 0.25 -right 
0.25 I pjxl.sh 
-copies 1" 

This line indicates the end of the print request: 

end of job 


Analyzing an error page 

If the print request fails, SharedPrint/UX also creates an error page. If the 
printer can print text hies, it prints the error page instead of the hie. If 
the printer cannot print text hies, SharedPrint/UX saves the error page as 

/var/opt/sharedprint/ ezzozlog. printername. save. 

The following is a sample error page. The meaning of each section of the page 
is described following the example. 


Error page for job tp-376 


Job owner = smith_b 

options = -orientation portrait 

f i le(s) = /usr/spooI/Ip/request/tp/dA0376toast 

title = fou r_fiIes 
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Hon Ju I 27 14:29:30 EOT 1992 

Can not determine a pipeline for this job . 
/usr/spool/lp/req uest/tp/dA0376toast 


Debug information for Job tp-376 


Job owner = smith_b 
options = 

file(s) = /usr/spooI/Ip/request/tp/dA0376toast 
Hon Jul 27 14:29:29 EDT 1992 
printer file type(s) = 
teksx 

JOB.OPTIOHS -copies 1 -orientation portrait -papersize 

letter -paperwidth 8.500000 -paperlength 11.000000 -top 0.5 -bottom 0.5 

-left 1.0 -right 1.0 -tab 8 -charheight 10.0 -columns 1 -wrap 1 -symbolset ISO.lOO 

-resolution 300 -page.reversaI 0 -co I I ate.cop i es 1 

processing "/usr/spool/lp/request/tp/dA0376toast" 
file type = pc 15 

These lines identify the job id: 


Error page for job tp-376 


This line identihes the job owner, 
job owner = smith_b 

This line shows the options passed to the Ip command by SharedPrint/UX: 

options = -orientation portrait 

This line identihes the hie to be printed with this print request. In most cases, 
only one hie is requested: 

file(s) = /usr/spool/lp/request/tp/dA0376toast 
This line shows the hlename: 

title = four_files 
This is the date the job was processed: 

Mon Jul 27 14:29:30 EDT 1992 
These lines identify the error for the hie: 

Can not determine a pipeline for this print request. 
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/usr/spool/lp/request/tp/dA0376toast 

The remaining lines provide the same debug information explained 
“Analyzing a debug page”. 
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SharedPrint/UX Printing Options 


This appendix describes options under two headings: 

■ The User Options - the options that you can set either through the 
(Graphical User Interface) GUI or the Ip command line. 

■ Printer Confignration File Options - the options that appear only in the 
printer’s conhguration hie, not in the SharedPrint/UX GUI. 

These options contain the default values for the behavior of the printer. 
However, these defaults are overriden when you use the Ip command. 


How SharedPrint/UX Applies Options 

SharedPrint/UX uses the following rules for applying options: 

1. If the user sets an option, the user value takes precedence over that option’s 
value in the printer’s conhguration hie. 

2. If the user omits a value for an option, the value in the printer conhguration 
hie is used. 

3. If neither the user nor the conhguration hie supplies a value for an option, a 
value is assigned by the hlters used to process the print request. 
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User Options 

These options can be set either through the GUI or by using the Ip command 
line, which has this format: 

Ip -dprinter -o" -optionl valuel -option2 value2 ... " 

For a given printer, these options can also be set in the printer conhguration 
hie (/var/opt/sharedprint/prmter.pcf) on the server, the system with the 
printer. If an option does not apply to the current print request, it is grayed 
out on the GUI. 

If you want to identify the hie type, use the -t filepathname.ext option. For 
example. 

Ip -dprinter -t filepathname.ext -o" -optionl valuel -option2 value2 ... ' 
The format for describing these options is: 

option-name (abbreviation) values 

■ banner (ban) {on, off} 

Determines if a banner page is printed. 

■ bgcolor (bg) .string 

Sets the background color for graphics print requests. No SharedPrint/UX 
hlters use this option, but other hlters can be created to use it. 

■ bitmapplane (bmp) integer 

Determines the bitmap plane to be printed when only a single plane is to be 
printed. The default is to print a full-depth bitmap. No SharedPrint/UX 
hlters use this option, but other hlters can be created to use it. 

■ bottom margin (bottom, bm) real-number 

Sets the bottom margin in inches for text and graphics print requests. 

■ charheight (point, ch) real-number 
Sets the character height for text hies. 
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charweight (weight, cw) integer 

Sets the character weight of text to a point size between —7 (a thin weight 
and +7 (a thick weight). 

copies (cop) integer 

Sets the number of copies to be printed. 

columns (cpl, columns per line, col per line) {1, 2, 4} 

Sets the page make-up to a single column (f), double column (2), or 
four-column format (4). Note that no SharedPrint/UX filters use the 
4-column format, but other filters can be created to use it. 

duplex (du) {long, short, off} 

Determines if the printer prints on both sides of the paper, using long-edge 
or short-edge binding, or prints on only one side (off). 

fgcolor (fg) string 

Sets the foreground color of graphics print requests. No SharedPrint/UX 
filters use this option, but other filters can be created to use it. 

lixedspacing (fs) {on, off} 

If on, uses fixed spacing for text. 

file type (ftype) string 

Tells the print request to use the file type that you enter rather than allowing 
SharedPrint/UX to detect the file type. For a list of file types, see the 

/opt/sharedprint/lib/config/Types.cf file on the server. 

filter pipe (fpipe) string 

Identifies a filter that overrides the default processing performed by 
SharedPrint/UX. This option is primarily intended to invoke filters that have 
been added to SharedPrint/UX. 

fit to page (ftp, fitpage) {on, off} 

If on, scales the graphic print request to the maximum size that completely 
fits on the page. If off, no scaling is performed, meaning that each pixel in 
the file is printed as one pixel on the page. 
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■ footer (foot, foot_string) left-string/center-string/right-string 

Places the text string you supply at the bottom of each page. This string can 
include any of the characters dehned for header. 

■ gamma (ga) real-number 

Sets the gamma correction value. To darken the image, use a number 
between 1 and 0; to lighten it, use a number higher than 1. 

■ header (head, head_string) left-string/center-string/right-string 

Places the text string you supply at the top of each page. The following 
special characters return the values indicated when they are included in this 
string: 

^ page number 

* literal space 

% date job is printed 

! hlename (Requires the -tfilename option 

of Ip) 

\ escape character 

For example, this command prints pages using a header of the hlename on 
the left. Page followed a space and the page number in the middle, and the 
date on the right. 

Ip -dLJet -tworksheetl -o"-header !/Page*#/"/," worksheetl 

For example, the hrst page might have the following header: 

worksheetl Page 1 Tue Aug 31 17:52:04 1993 

■ italic (it) {1, 0} 

If 1, prints text hies using an italic font. 

■ left (Im, left margin) real-number 

Sets the left margin in inches for text and graphics print requests. 

■ lines_per_inch (Ipi) real-number 

Sets the number of lines per inch. The default value depends on the point 
size of the font. 
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To print text documents that are formatted for 66 lines per page, set the 
following options: 

□ Ipi 6.3 

□ wrap off 

□ top_margin 0.25 

□ bottom_margin 0.25 

■ nobgcolor (nobg) {on, off} 

If on, sets the background color to white. 

■ orientation (or, orient) {landscape, portrait} 

Determines the orientation of the page, portrait prints the text or x-axis of 
the bitmap parallel to the short edge of the paper, landscape prints the text 
or x-axis of the bitmap parallel to the long edge of the paper. 

■ paperlength (pi) real-number 

Sets the length of the page in inches, if you set papersize to variable. 

■ papersize (psize) {variable, letter, legal, b, c, d, e, a3, a4, a5, b3, b4, b5} 

Sets the paper size to one of these sizes: 


variable 

letter 

legal 

b 

c 

d 

e 

a3 

a4 

a5 

b4 

b5 


lets you set the size by paperlength and paperwidth 

8.50 by 11.00 inches 

8.50 by 14.00 inches 

11.00 by 17.00 inches 

17.00 by 22.00 inches 

22.00 by 34.00 inches 

34.00 by 44.00 inches 

11.69 by 16.54 inches (297mm by 420mm) 

8.27 by 11.69 inches (210mm by 297mm) 

5.38 by 8.27 inches (137mm by 210mm) 

9.84 by 13.90 inches (257mm by 364mm) 

5.93 by 9.89 inches (182mm by 257mm) 


■ papersonrce (psrc, psonrce) {npper, lower, mannal} 


Feeds paper from the upper tray, lower tray, or feeds paper manually. 
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■ paperwidth (pw) real-number 

Sets the length of the page in inches, if you set papersize to variable. 

■ pitch (pi, charspace) real-number 

Sets the number of characters printed per (horizontal) inch. This value is 
used only if fixedspacing is set to on. 

■ pixelexp (pex) integer 

Determines the size of the printed image: 

□ To enlarge the image - Enter a number greater than 1. 

□ To shrink the image - Enter a number between 1 and 0. 

□ To hll the page - Enter 0 or select Best Fit on Paper. 

□ To print unchanged - Enter 1 or leave blank. 

■ print quality (pq, printqa) integer 

Sets the output quality. Enter an integer between 0 and 100, using 0 for 
draft quality (to save toner) and 100 for professional quality. 

■ resolution (res) real-number 

Sets the resolution of the page in dots per inch (dpi). The default is 300 dpi. 

■ raw {on, off} 

Submits the hie to the requested printer, ignoring all other options. 

■ right margin (rm, right) real-number 

Sets the right margin in inches for text and graphics print requests. 

■ start pos (spos, startpos){on, off} 

If set to on, positions the graphic at the top left margin. If set to off, centers 
the graphic on the page. 

■ symbol set (ss, symbolset) string 

Sets the character set mapping, dehning how character codes are mapped to 
symbol shapes. Eor character sets you can use, see the conhguration hie for 
this printer. 

■ tabs (tab, tabspace) integer 
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Sets the number of spaces between tabs. 

■ top margin (tm, top margin) real-number 

Sets the top margin in inches for text and graphics print requests. 

■ typeface (tf) string 

Set the typeface for text hies to one supported by this printer. For typefaces 
you can enter, see the conhguration hie for this printer. 

■ wrap (wr) {on, off} 

If on, wraps lines that exceed the right margin. If off, truncates lines that 
exceed the margin. 


Printer Configuration File Options 

The following options can be set in the printer conhguration hie, but do not 
appear in the SharedPrint/UX GUI. They contain the default values for the 
behavior of the printer. 

However, these default values can be overriden by using the Ip command line, 
which has this format: 

Ip -dprinter -o" -optionl valuel -option2 value2 ..." 

The format for describing these options is: 

option-name (abbreviation) values 

■ collate copies (cc) {on, off} 

If on, collates a multi-page, multi-copy document. 

■ driver string 

Identihes the driver to use. 

■ front banner (fb) string 

Uses the banner program named for printing a banner page at the beginning 
of a job. 
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■ media type (mt, media) string 

Identifies the type of media that is loaded in the printer/plotter. 

■ page reversal (pr){on, off} 

If on, reverses the order of text page output. 

■ pen color (pc) string 

Sets the pen colors loaded in the pen plotter for graphics print requests. The 
format is color 1 :color2:color3... colorS where: 

colorn is the pen color loaded in carousel slot number n. Use the following 
values for color. (Except for red-violet, they are first three letters of the 
color.) 


aqu 

bla 

bln 

bro 

gre 

ora 

red 

rdv 

vio 

yel 


aqua 

black 

blue 

brown 

green 

orange 

red 

red-violet 

violet 

yellow 


■ rear banner (rb) string 


Uses the banner program for printing a banner page at the end of a job. 
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CGM Support 


This appendix defines the support for CGM to HP-GL/2 conversion under 
these topics: 

■ Starbase and HP-PHIGS CGM Generators 

■ CGM Element Bounds 


Starbase and HP-PHIGS CGM Generators 

The following list contains the CGM elements supported by the cgmhpgl2 
(CGM to HP-GL/2) filter. This list represents the CGM elements emitted by 
the StarBase and HP-PHIGS CGM generators. 

■ 0 1 BEGIN METAEILE 

■ 02 END METAEILE 

■ 03 BEGIN PICTURE 

■ 04 BEGIN PICTURE BODY 

■ 05 END PICTURE 

■ 1 1 METAEILE VERSION 

■ 1 2 METAEILE DESCRIPTION 

■ 1 3 VDC TYPE 

■ 1 4 INTEGER PRECISION 

■ 1 5 REAL PRECISION 

■ 1 6 INDEX PRECISION 
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■ 1 7 COLOR PRECISION 

■ 1 8 COLOR INDEX PRECISION 

■ 1 11 METAEILE ELEMENT LIST 

■ 2 1 SCALING MODE 

■ 22 COLOR SELECTION MODE 

■ 23 LINE WIDTH SPECIEICATION MODE 

■ 25 EDGE WIDTH SPECIEICATION MODE 

■ 26 VDC EXTENT 

■ 32 VDC REAL PRECISION 

■ 35 CLIP RECTANGLE 

■ 36 CLIP INDICATOR 

■ 4 1 POLYLINE 

■ 47 POLYGON 

■ 48 POLYGON SET 

■ 4 10 GENERALIZED DRAWING PRIMITIVE 

■ 4 12 CIRCLE 

■ 4 15 CIRCLULAR ARC CENTER 

■ 52 LINE TYPE 

■ 53 LINE WIDTH 

■ 54 LINE COLOR 

■ 5 22 INTERIOR STYLE 

■ 5 23 EILL COLOR 

■ 5 24 HATCH INDEX 

■ 5 27 EDGE TYPE 

■ 5 28 EDGE WIDTH 

■ 5 29 EDGE COLOR 
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■ 5 30 EDGE VISIBILITY 

■ 5 34 COLOR TABLE 


CGM Element Bounds 


The following are the specihc CGM element bounds: 


VDC TYPE 

INTEGER 
PRECISION 
REAL PRECISION 

INDEX PRECISION 
COLOR PRECISION 


0 , 1 

16 

0 9 23 32-bit floating-point 

8 

8 


COLOR INDEX 
PRECISION 
METAEILE 
ELEMENT LIST 

SCALING MODE 

LINE WIDTH 

SPECIEICATION 

MODE 

EDGE WIDTH 

SPECIEICATION 

MODE 

VDC EXTENT 

VDC REAL 
PRECISION 

CLIP RECTANGLE 

CLIP INDICATOR 

POLYLINE 


8 

-1 1 Drawing plus Control Set 

0 , 1 
0 , 1 

0 , 1 


VDC values: 0 - 32767, 0.0 - 32767.0 
0 9 23 32-bit floating-point 

VDC values: 0.0 - 32767.0 

0 , 1 

2-1024 points VDC values: 0 - 32767, -32767.0 - 
32767.0 
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POLYGON 

3-1024 points VDC values: 0 - 32767, -32767.0 - 
32767.0 

POLYGON SET 

3-1024 points VDC values: -32767.0 - 32767.0 

GENERALIZED 

DRAWING 

PRIMITIVE 

gdp-id: -100 0-1024 points VDC values : -32767.0 - 
32767.0 datarecord contents : 0-1024 4-byte integer 
values : 0 - 16 

CIRCLE 

VDC values: 0 - 32767, -32767.0 - 32767.0 

CIRCLULAR ARC 
CENTER 

VDC values: 0 - 32767, -32767.0 - 32767.0 

LINE TYPE 

1 - 5 

LINE WIDTH 

1 - 32767, 0.0 - 32767.0 

LINE COLOR 

0 - 255 

INTERIOR STYLE 

0, 1, 3, 4 

EILL COLOR 

0 - 255 

HATCH INDEX 

3, 4 

EDGE TYPE 

1 - 5 

EDGE WIDTH 

1 - 32767, 0.0 - 32767.0 

EDGE COLOR 

0 - 255 

EDGE VISIBILITY 

0, 1 

COLOR TABLE 

0, 127 start index 
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Meeting NCS or DCE Requirements 


SharedPrint/UX depends on either Network Computing System (NCS) or HP 
DCE/9000. This appendix is provided for network administrators who have 
not set up NCS in the standard manner or have not set up HP 9000/DCE to 
accommodate SharedPrint/UX. 

■ If HP DCE/9000 is set up, use the following section to have it work with 
SharedPrint/UX. 

■ If NCS is set up, SharedPrint/UX will work with no changes. If you don’t 
know if NCS is set up, see the section “Checking the NCS Setup.” 


Meeting HP DCE/9000 Requirements 

If you want to have both SharedPrint/UX and HP DCE/9000 on your network, 
perform these steps to have them work together: 

1. Use these steps to stop the SharedPrint/UX server: 

a. Eind the PID for the spserver. Type: 

ps -efigrep spserver 

b. Kill the spserver. Type: kill -KILL PID 

c. Edit the /etc/inittab hie as follows: 

i. Add a # (pound symbol) at the start of this line: 

Shpr:: "/opt/sharedprint/bin/spserver" 

ii. Save and exit the hie. 
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2. To have DCE also work with the HP-UX Audio server (another NCS-based 
application) you need to stop it also; at later step shows you how to restart 
it. Use these steps to stop the Aserver: 

a. Find the PID for the Aserver. Type: 

ps -efigrep Aserver 

b. Of the two processes displayed, remove the lower-numbered PID. Type: 
kill PID 

c. To check if both processes were killed, type: 

ps -efigrep Aserver 

d. If one process still exists, remove it by typing: 

kill -KILL PID 

3. Stop glbd (via drm_admin “stop ”) if it is running. 

4. Stop llbd (via kill(1)). 

5. Conhgure HP DCE/9000 as needed, using the DCE/9000 Release Notes in 
the following hies: 

/opt/dce/newconfig/RelNotes/HPDCEl.3RelNotes.ps 
/opt/dce/newconfig/RelNotes/HPDCEl.3RelNotes.txt 

6. Run /etc/rc.config.d/ncs to restart NCS daemons. 

7. Restart the SharedPrint/UX and Audio servers as follows: 

/opt/sharedprint/bin/spserver 
/opt/audio/bin/Aserver -f 

8. Edit the /etc/inittab hie to add this line (or, if the line already exists, 
remove the #): 

Shpr:: "/opt/sharedprint/bin/spserver" 
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Checking the NCS Setup 

Use this procedure to check if you already have one or more glbd daemons 

running on your network: 

1. Log on to any SharedPrint/UX server or client machine as root. 

2. Be sure that NCS/NCK (the Network Computing Kernel) is installed on all 
the system as follows: 

a. Check for the existence of the hie /usr/sbin/ncs/glbd. If this hie 
exists, you can assume that NCK has been installed. 

b. If NCK is not installed, install it from your HP-UX installation media. 
You will need the NCSNCK-RUN hleset from the NETWORKING 
partition and the NCSNCK-MAN hleset from the REFERENCEDOC 
partition. 

3. Enter the following command: 

/opt/sharedprint/bin/splistpr -glbd 

If you receive a “communications failure” error message, use the next section 
“Choosing Systems to Run glbd” to set up NCS. If no error appears, NCS is 
correctly set up. 


Choosing Systems to Run glbd 

You need to run at least one glbd to service all the SharedPrint/UX servers 
within the network. However, if you have a large network, you should increase 
the chance that at least one daemon is available at all times, by running glbd 
on at least two systems. 

When choosing systems, be sure that each SharedPrint/UX server is able to 
communicate (via TCP/IP) with at least one host that is running glbd. If 
you have TCP/IP running within your network, you should have no problem 
hnding systems on which to run glbd; TCP/IP provides the underlying 
communications mechanism for NCS. 
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The following guidelines give additional suggestions for selecting systems on 
which to run glbd: 

■ The systems running the NCS daemons should be stable; they should not be 
systems that are frequently taken down or unavailable. 

■ If you already have designated “server” systems within your network, these 
systems are generally good candidates for the glbd daemon. These server 
systems could be hie servers, print servers, mail hubs, or diskless servers. 

■ Take into account the layout of your network. If your network consists of 
multiple segments connected to a backbone, it is a good idea to place a glbd 
server on a system within each of these segments. This will allow software 
running on machines within a segment to access a glbd, if the backbone or 
other segments of the network are unreachable. 

Once you have selected systems to run the glbd daemon, use the following 
guidelines to choose which procedure to follow. 

Single LAN 

If your site consists of a single local area network, perform these procedures to 
set up NCS: 

1. Perform “Starting the First glbd Daemon” to start the hrst glbd on a 
network. 

2. If you want to set up additional glbds, continue with “Starting Additional 
glbds”. 

Multiple LANs 

If your site consists of multiple local area networks, each local area network 
needs a glbd. For each local area network, perform these procedures: 

1. Perform “Checking the NCS Setup” to see if a glbd is running. 

2. If no gbld is running, perform “Starting the First glbd Daemon” to start 
the hrst glbd. 

3. Once a glbd is running on the network, perform “Starting Additional glbds” 
if you want to start subsequent glbds as replicas of the hrst glbd. A replica 
glbd is useful in case the hrst glbd somehow becomes unavailable. 
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starting the First gibd Daemon 

After choosing systems to run glbds from the preceding section, use the 
following procedure to start glbd. 

1. For use later in this procedure, write down the names and internet addresses 
of the hosts that will run glbd daemons. 

2. Be sure that NCS/NCK (the Network Computing Kernel) is installed on all 
the systems where you plan to run glbd as follows: 

a. Check for the existence of the hie /usr/sbin/ncs/glbd. The following 
example shows the contents of an /usr/sbin/ncs directory: 

"/, Is /usr/sbin/ncs 

drm_admin lb_admin perf uuid_gen 
glbd lb_test stcode 

If this hie exists, you can assume that NCK has been installed. 

b. If NCK is not installed, install it from your HP-UX installation media. 
You will need the NCSNCK-RUN hleset from the NETWORKING 
partition and the NCSNCK-MAN hleset from the REFERENCEDOC 
partition. 

3. On each host that will run glbd, use the following steps, which describe how 
to show if the NCS local location broker daemon (llbd) is running, then 
how to start it if not running. 

a. Use the ps command to see if llbd is currently running. (If the daemon 
is running, the output from ps will show the llbd process; if llbd is not 
running, ps will not display any output.) 

The following example shows typical output from ps when llbd is 
running. 

"/. ps -e I grep llbd 
11626 ? 2:11 llbd 

b. If llbd is not running, issue the llbd startup command, and verify that 
the daemon has started as shown in this example. 
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"/, /usr/sbin/ncs/llbd 
"/. ps -e I grep llbd 
11628? 0:00 llbd 


c. Perform the following steps to automate the llbd and glbd startup 
processes, so that they restart whenever the host is rebooted: 

i. Open the /etc/rc.config.d/ncs hie 

ii. Check that the START_LLBD variable is set to 1. If it’s set to 0, edit 
the hie to change the value to 1. 

hi. Check that the START_GLBD variable is set to 1. If it’s set to 0, edit 
the hie to change the value to 1. 
iv. Save and exit this hie. 

d. Make sure that the following lines are in the hie /etc/netlinkrc. If 
these lines are missing, add them to the end of the /etc/netlinkrc hie. 

if [ -f /etc/rc.config.d/ncs ] 
then 

/etc/rc.config.d/ncs 
fi 

4. On one of the hosts that will run glbd, start the hrst glbd daemon by 
doing the following: 

a. Become root. 

b. Start the glbd daemon using the -create, -first, and -family ip 
options and verify that the daemon has started. For example. 


# /usr/sbin/ncs/glbd -create -first -family ip 

# ps -e I grep glbd 

11630? 0:00 glbd 


c. Verify that you can communicate with the glbd daemon using the 
following steps and example: 

i. Start the NCS utility drm_admin. (You can run drm_admin from any 
host where NCS/NCK is installed.) 


C-6 Meeting NCS or DCE Requirements 



ii. Set the default glbd to be the one you just started. To specify a glbd 
host on HP-UX, use a name with the form ip: host. For host, use 
either a network address (preceded by a sign) or a system name. 

The following example shows how to start drm_admin and set the default 
glbd to the daemon running on the host ip:mars. 


# /usr/sbin/ncs/drm_admin 
drm_admin: set -o gib -h iprmars 

Default object: gib default host: ip:mars state: in service 

Checking clocks of gib replicas 
ip:mars 1992/07/14.15:38 
drm_admin: quit 

# 


5. Start additional glbds by performing “Starting Additional glbds”, if you 
want an extra glbd. 


Starting Additional glbds 

An additional glbd daemon is useful in case the hrst glbd somehow becomes 
unavailable. If you want more than one glbd daemon, start the additional 
daemons by following these steps. 

1. Be sure that NCS/NCK (the Network Computing Kernel) is installed on all 
the systems where you plan to run glbd as follows: 

a. Check for the existence of the hie /usr/sbin/ncs/glbd. The following 
example shows the contents of an /usr/sbin/ncs directory: 

"/, Is /usr/sbin/ncs 

drm_admin lbcm_cache_dir uuid_gen 

glbd llbd uuidname. txt 

lb_admin perf 

If this hie exists, you can assume that NCK has been installed. 
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b. If NCK is not installed, install it from your HP-UX installation media. 
You will need the NCSNCK-RUN fileset from the NETWORKING 
partition and the NCSNCK-MAN hleset from the REFERENCEDOC 
partition. 

2. On each host that will run glbd, use the following steps, which describe how 
to show if the NCS local location broker daemon (llbd) is running, then 
how to start it if not running. 

a. Use the ps command to see if llbd is currently running. (If the daemon 
is running, the output from ps will show the llbd process; if llbd is not 
running, ps will not display any output.) 

The following example shows typical output from ps when llbd is 
running. 

"/. ps -e I grep llbd 
11626? 2:11 llbd 

b. If llbd is not running, issue the llbd startup command, and verify that 
the daemon has started as shown in this example. 


"/, /usr/sbin/ncs/llbd 
"/. ps -e I grep llbd 
11628? 0:00 llbd 


3. Perform the following steps to automate the llbd and glbd startup 
processes, so that they restart whenever the host is rebooted: 

a. Open the /etc/rc.config.d/ncs hie 

b. Check that the START_LLBD variable is set to 1. If it’s set to 0, edit the 
hie to change the value to 1. 

c. Check that the START_GLBD variable is set to 1. If it’s set to 0, edit the 
hie to change the value to 1. 

d. Save and exit this hie. 
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4. Make sure that the following lines are in the hie /etc/netlinkrc. If these 
lines are missing, add them to the end of the /etc/netlinkrc hie. 

if [ -f /etc/rc.config.d/ncs ] 
then 

/etc/rc.config.d/ncs 

fi 

5. Verify that the clocks on each glbd host are within two minutes of each 
other. If the clocks are skewed (that is, if they are not within two minutes of 
each other), reset the clocks. Use the date command to check the system 
clock and reset it, if necessary. 


"/, date 

Tue Jul 14 15:40:47 EDT 1992 


In general, when you synchronize skewed clocks, you should move the time 
on the slower clock forward. 

6. Become root and start the additional glbd daemons on the appropriate 
hosts, using the -create and -from options. Specify the glbd host whose 
copy of the database will be used to initialize the new database. After 
you start glbd, use the ps command to verify that the daemon started 
successfully. 

The following example shows how to start a glbd by initializing its database 
from the glbd database on the host ip:mars. The example also shows how 
to verify that the daemon process exists. 


# /usr/sbin/ncs/glbd -create -from ip:mars 

# ps -e I grep glbd 

11632? 0:00 glbd 


7. Verify that you can communicate with each newly started glbd, by using 
the drm_admin utility, setting the default to a glbd that you just started. 

The following example sets the default glbd to a newly started daemon 
on ip:pluto and then to a newly started daemon on ip:saturn. Note 
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that the output also indicates whether the clocks on the the glbd hosts are 
synchronized. (You’ll receive a warning if the clocks are skewed.) 


# /usr/sbin/ncs/drm_admin 
drm_admin: set -o gib -h ip:pluto 

Default object: gib default host: ip:pluto state: in service 

Checking clocks of gib replicas 
ip:pluto 1992/07/14.15:45 

ip:Saturn 1992/07/14.15:45 

ip:mars 1992/07/14.15:45 
drm_admin: set -o gib -h ip:saturn 

Default object: gib default host: ip:saturn state: in service 

Checking clocks of gib replicas 
ip:Saturn 1992/07/14.15:45 
ip:pluto 1992/07/14.15:45 

ip:mars 1992/07/14.15:45 

drm_admin: quit 
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